ELYWARE VIDEO MIXER v4.6.1 - Web Edition
======================================

Runs on any computer with Python 3. Nothing to install.

BLOCKED BY YOUR OS? (this is normal)
-----------------------------------
This beta is not code-signed yet, so Mac and Windows warn that the
publisher is unverified. That is a missing signature, not a virus.
Check the SHA-256 on elyware.net/video-mixer/ if you want to be sure.

Mac:     the old right-click > Open no longer works on macOS 15+.
         Click Done on the warning, then System Settings >
         Privacy & Security > Open Anyway. Or in Terminal:
           xattr -dr com.apple.quarantine "/Applications/Video Mixer.app"
         First launch takes about 20 seconds.

Windows: right-click the ZIP > Properties > tick Unblock > OK
         BEFORE extracting. Then More info > Run anyway if asked.


START THE MIXER
---------------
Mac:      double-click run-video-mixer.command
Windows:  double-click "Run Video Mixer.bat"
Any OS:   python3 video_mixer_web.py

The mixer opens at http://127.0.0.1:5555


STOCK FOOTAGE (Pixabay)
-----------------------
The Stock tab needs a free Pixabay API key, which you get here:
https://pixabay.com/api/docs/

You can paste the key itself, or just paste the whole example URL from
that page. The app pulls the key out either way.

Clips cache to ~/VideoMixer/cache/stock before they play.


STOCK BRIDGE FOR RESOLUME
-------------------------
Sends Pixabay clips straight into Resolume Arena or Avenue clip slots.

1. In Resolume: Preferences > Webserver > enable it (port 8080).
2. Mac: double-click run-resolume-bridge.command
   Any OS: python3 resolume_bridge.py
3. The bridge opens at http://127.0.0.1:5566

Heavy clips scrub better after converting to DXV with Resolume Alley.


WHAT'S NEW SINCE 4.1
--------------------
4.6.1 Looping clips can no longer freeze after one playback. If the
      backup decoder is not ready at the loop point, the clip rewinds
      and keeps playing instead of stopping on its last frame.
4.6   Loops cut on the exact frame instead of dissolving, so VJ loops
      repeat with no visible seam. Deck previews show the whole frame at
      full height. The Mac app opens full height.
4.5.1 Stock search works on every Mac. Earlier Mac builds could not make
      a secure connection to Pixabay unless python.org Python was
      installed, and showed "Could not reach Pixabay."
4.5  Create a Slide composer with twelve looping backgrounds, live 16:9
     preview, slide colors, motion, hue cycling and a capped strobe.
4.4  Seamless video looping. No more black frame at the loop point.
4.3  Screenfolk Live: publish the program canvas to a Screenfolk player
     over WebRTC. See SCREENFOLK_LIVE.md.
4.2  Clip pads, MIDI mapping, beat quantize, audio-reactive FX, LFO,
     overlay layer, program recording, hover scrub, REST control API.

Full details in CHANGELOG.md.


FILES
-----
~/VideoMixer/transitions/   drop custom .js transitions here
~/VideoMixer/cache/stock/   cached Pixabay clips
~/VideoMixer/config.json    Pixabay key and Resolume host/port

Feedback: hello@elyware.net
